gtk: mark few GtkFileChooser functions as nullable
authorBilal Elmoussaoui <bil.elmoussaoui@gmail.com>
Sat, 1 Jan 2022 18:11:10 +0000 (19:11 +0100)
committerBilal Elmoussaoui <bil.elmoussaoui@gmail.com>
Sat, 1 Jan 2022 18:11:10 +0000 (19:11 +0100)
- get_file, if no file is selected returns a NULL
- get_id, if the interface doesn't implement such function returns NULL

gtk/gtkfilechooser.c

index c472e115db3a4bd2893afe1e0661a657113c8784..78cfdb1001c7d42393e198ce93379ea752cacfe8 100644 (file)
@@ -523,7 +523,7 @@ gtk_file_chooser_set_file (GtkFileChooser  *chooser,
  * If the file chooser is in folder mode, this function returns
  * the selected folder.
  *
- * Returns: (transfer full): a selected `GFile`. You own the
+ * Returns: (transfer full) (nullable): a selected `GFile`. You own the
  *   returned file; use g_object_unref() to release it.
  */
 GFile *
@@ -794,7 +794,7 @@ gtk_file_chooser_set_choice (GtkFileChooser  *chooser,
  *
  * Gets the currently selected option in the 'choice' with the given ID.
  *
- * Returns: the ID of the currently selected option
+ * Returns: (nullable): the ID of the currently selected option
  */
 const char *
 gtk_file_chooser_get_choice (GtkFileChooser  *chooser,